<!DOCTYPE html>
<html lang="en">

<head>
	<meta charset="UTF-8">
	<meta name="viewport" content="width=device-width, initial-scale=1.0, maximum-scale=1.0, user-scalable=no">
	<meta name="keywords" content="Nacos,2.0.0" />
	<meta name="description" content="Nacos 2.0.0-BETA 文档" />
	<!-- 网页标签标题 -->
	<title>Nacos 2.0.0-BETA 文档</title>
	<link rel="shortcut icon" href="https://img.alicdn.com/tfs/TB1hgJpHAPoK1RjSZKbXXX1IXXa-64-64.png"/>
	<link rel="stylesheet" href="/build/documentation.css" />
</head>
<body>
	<div id="root"><div class="documentation-page" data-reactroot=""><header class="header-container header-container-normal"><div class="header-body"><a href="/zh-cn/index.html"><img class="logo" src="/img/nacos_colorful.png"/></a><div class="search search-normal"><span class="icon-search"></span></div><span class="language-switch language-switch-normal">En</span><div class="header-menu"><img class="header-menu-toggle" src="/img/menu_gray.png"/><ul><li class="menu-item menu-item-normal"><a href="/zh-cn/index.html">首页</a></li><li class="menu-item menu-item-normal menu-item-normal-active"><a href="/zh-cn/docs/what-is-nacos.html">文档</a></li><li class="menu-item menu-item-normal"><a href="/zh-cn/blog/index.html">博客</a></li><li class="menu-item menu-item-normal"><a href="/zh-cn/community/index.html">社区</a></li><li class="menu-item menu-item-normal"><a href="https://cn.aliyun.com/product/aliware/mse?spm=nacos-website.topbar.0.0.0">企业版Nacos</a><img class="menu-img" src="https://img.alicdn.com/tfs/TB1esl_m.T1gK0jSZFrXXcNCXXa-200-200.png"/></li><li class="menu-item menu-item-normal"><a href="http://console.nacos.io/nacos/index.html">控制台样例</a></li></ul></div></div></header><div class="bar"><div class="bar-body"><img src="/img/docs.png" class="front-img"/><div class="bar-title"><span>Nacos 文档</span><div class="bone bone-light"></div></div><img src="/img/docs.png" class="back-img"/></div></div><section class="content-section"><div class="content-body"><div class="sidemenu"><div class="sidemenu-toggle"><img src="https://img.alicdn.com/tfs/TB1E6apXHGYBuNjy0FoXXciBFXa-200-200.png"/></div><ul><li class="menu-item menu-item-level-1"><span>Nacos </span><ul><li style="height:180px;overflow:hidden" class="menu-item menu-item-level-2"><span>Nacos是什么?<img style="transform:rotate(0deg)" class="menu-toggle" src="/img/arrow_down.png"/></span><ul><li class="menu-item menu-item-level-3"><a href="/zh-cn/docs/what-is-nacos.html" target="_self">Nacos简介</a></li><li class="menu-item menu-item-level-3"><a href="/zh-cn/docs/concepts.html" target="_self">概念</a></li><li class="menu-item menu-item-level-3"><a href="/zh-cn/docs/architecture.html" target="_self">架构</a></li><li class="menu-item menu-item-level-3"><a href="/zh-cn/docs/feature-list.html" target="_self">功能和需求列表</a></li></ul></li><li style="height:324px;overflow:hidden" class="menu-item menu-item-level-2"><span>快速开始<img style="transform:rotate(0deg)" class="menu-toggle" src="/img/arrow_down.png"/></span><ul><li class="menu-item menu-item-level-3"><a href="/zh-cn/docs/quick-start.html" target="_self">Nacos</a></li><li class="menu-item menu-item-level-3"><a href="/zh-cn/docs/quick-start-spring.html" target="_self">Nacos Spring</a></li><li class="menu-item menu-item-level-3"><a href="/zh-cn/docs/quick-start-spring-boot.html" target="_self">Nacos Spring Boot</a></li><li class="menu-item menu-item-level-3"><a href="/zh-cn/docs/quick-start-spring-cloud.html" target="_self">Nacos Spring Cloud</a></li><li class="menu-item menu-item-level-3"><a href="/zh-cn/docs/quick-start-docker.html" target="_self">Nacos Docker</a></li><li class="menu-item menu-item-level-3"><a href="/zh-cn/docs/use-nacos-with-dubbo.html" target="_self">Nacos Dubbo</a></li><li class="menu-item menu-item-level-3"><a href="/zh-cn/docs/use-nacos-with-kubernetes.html" target="_self">Nacos k8s</a></li><li class="menu-item menu-item-level-3"><a href="/zh-cn/docs/nacos-sync.html" target="_self">Nacos Sync</a></li></ul></li><li style="height:288px;overflow:hidden" class="menu-item menu-item-level-2"><span>用户指南<img style="transform:rotate(0deg)" class="menu-toggle" src="/img/arrow_down.png"/></span><ul><li class="menu-item menu-item-level-3"><a href="/zh-cn/docs/sdk.html" target="_self">Java的SDK</a></li><li class="menu-item menu-item-level-3"><a href="/zh-cn/docs/other-language.html" target="_self">其他语言的SDK</a></li><li class="menu-item menu-item-level-3"><a href="/zh-cn/docs/open-api.html" target="_self">Open-API指南</a></li><li class="menu-item menu-item-level-3"><a href="/zh-cn/docs/nacos-spring.html" target="_self">Nacos Spring</a></li><li class="menu-item menu-item-level-3"><a href="/zh-cn/docs/system-configurations.html" target="_self">Nacos系统参数介绍</a></li><li class="menu-item menu-item-level-3"><a href="/zh-cn/docs/auth.html" target="_self">权限认证</a></li><li class="menu-item menu-item-level-3"><a href="/zh-cn/docs/faq.html" target="_self">FAQ</a></li></ul></li><li style="height:36px;overflow:hidden" class="menu-item menu-item-level-2"><span>运维指南<img style="transform:rotate(-90deg)" class="menu-toggle" src="/img/arrow_down.png"/></span><ul><li class="menu-item menu-item-level-3"><a href="/zh-cn/docs/deployment.html" target="_self">部署手册</a></li><li class="menu-item menu-item-level-3"><a href="/zh-cn/docs/cluster-mode-quick-start.html" target="_self">集群部署说明</a></li><li class="menu-item menu-item-level-3"><a href="/zh-cn/docs/management-api.html" target="_self">运维API</a></li><li class="menu-item menu-item-level-3"><a href="/zh-cn/docs/console-guide.html" target="_self">控制台手册</a></li><li class="menu-item menu-item-level-3"><a href="/zh-cn/docs/monitor-guide.html" target="_self">监控手册</a></li><li class="menu-item menu-item-level-3"><a href="/zh-cn/docs/nacos-config-benchmark.html" target="_self">Nacos配置模块压测报告</a></li><li class="menu-item menu-item-level-3"><a href="/zh-cn/docs/nacos2-config-benchmark.html" target="_self">Nacos2.0配置模块压测报告</a></li><li class="menu-item menu-item-level-3"><a href="/zh-cn/docs/nacos-naming-benchmark.html" target="_self">Nacos服务发现模块压测报告</a></li><li class="menu-item menu-item-level-3"><a href="/zh-cn/docs/nacos2-naming-benchmark.html" target="_self">Nacos2.0服务发现模块压测报告</a></li><li class="menu-item menu-item-level-3"><a href="/zh-cn/docs/nacos-sync-use.html" target="_self">其他环境迁移到Nacos</a></li></ul></li><li style="height:36px;overflow:hidden" class="menu-item menu-item-level-2"><span>Nacos 2.0<img style="transform:rotate(-90deg)" class="menu-toggle" src="/img/arrow_down.png"/></span><ul><li class="menu-item menu-item-level-3"><a href="/zh-cn/docs/2.0.0-alpha.html" target="_self">2.0-BETA</a></li><li class="menu-item menu-item-level-3"><a href="/zh-cn/docs/2.0.0-upgrading.html" target="_self">升级文档</a></li></ul></li><li style="height:36px;overflow:hidden" class="menu-item menu-item-level-2"><span>开源共建<img style="transform:rotate(-90deg)" class="menu-toggle" src="/img/arrow_down.png"/></span><ul><li class="menu-item menu-item-level-3"><a href="/zh-cn/docs/contributing.html" target="_self">贡献源码</a></li><li class="menu-item menu-item-level-3"><a href="/zh-cn/docs/contributing-flow.html" target="_self">贡献流程</a></li><li class="menu-item menu-item-level-3"><a href="/zh-cn/docs/pull-request.html" target="_self">pull request模板</a></li><li class="menu-item menu-item-level-3"><a href="/zh-cn/docs/how-to-reporting-bugs.html" target="_self">如何提交问题报告</a></li></ul></li><li style="height:36px;overflow:hidden" class="menu-item menu-item-level-2"><span>社区<img style="transform:rotate(-90deg)" class="menu-toggle" src="/img/arrow_down.png"/></span><ul><li class="menu-item menu-item-level-3"><a href="/zh-cn/docs/community.html" target="_self">社区</a></li><li class="menu-item menu-item-level-3"><a href="/zh-cn/docs/nacos-dev.html" target="_self">开发团队</a></li></ul></li></ul></li></ul></div><div class="doc-content markdown-body"><h1>Nacos 2.0.0-BETA 文档</h1>
<p>经过社区近5个月的讨论和开发， Nacos 基于长连接的2.0.0版本的核心功能已开发完成，目前开放2.0.0-BETA版本，供社区公测。</p>
<p><strong>注意，ALPHA，BETA版本仅供测试讨论，请在测试及预发环境中使用。ALPHA，BETA版本提供的接口API及功能呈现结果可能会和正式版本存在不一致的情况，请以后续正式版本为准</strong></p>
<p>2.0.0-ALPHA版本暂时为独立版本，无法进行服务端1.X版本到2.0.0-ALPHA的平滑升级，正式版本时会支持部分版本到该版本的平滑升级，请关注后续的升级文档。</p>
<p>2.0.0-BETA新增平滑升降级的能力，详情请查看<a href="">Nacos2.0升级文档</a> 。</p>
<h2>Nacos 2.0.0版本压测</h2>
<p>详情见：<a href="/zh-cn/docs/nacos2-naming-benchmark.html">Nacos2.0服务发现模块压测报告</a> 以及 <a href="/zh-cn/docs/nacos2-config-benchmark.html">Nacos2.0配置模块压测报告</a> 。</p>
<h2>新版本部署</h2>
<p>参考<a href="https://nacos.io/zh-cn/docs/deployment.html">Nacos部署手册</a> ,将版本相关替换成2.0.0-BETA。</p>
<h2>功能完成度及旧版本客户端适配情况：</h2>
<h3>配置中心</h3>
<h4>JAVA SDK</h4>
<ul>
<li>完全兼容1.X客户端所有API接口方法；</li>
<li>完全实现2.X客户端所有API接口方法。</li>
</ul>
<h4>其他语言 SDK</h4>
<ul>
<li>完全兼容</li>
</ul>
<h4>openAPI</h4>
<ul>
<li>完全兼容所有配置中心相关openAPI。</li>
</ul>
<h3>服务发现</h3>
<p>由于服务发现的数据模型发生了比较重大的改变，因此有少量功能暂时未支持。</p>
<h4>JAVA SDK</h4>
<ul>
<li>兼容1.X客户端服务相关接口；</li>
<li>实现2.X客户端非持久化服务接口。</li>
</ul>
<h4>其他语言 SDK</h4>
<ul>
<li>仅兼容非持久化服务实例相关操作。</li>
</ul>
<h4>openAPI</h4>
<ul>
<li>注册实例（支持）</li>
<li>注销实例（支持）</li>
<li>修改实例（支持）</li>
<li>查询实例列表（支持）</li>
<li>查询实例详情（支持）</li>
<li>发送实例心跳（支持）</li>
<li>创建服务（支持）</li>
<li>删除服务（支持）</li>
<li>修改服务（支持）</li>
<li>查询服务（支持）</li>
<li>查询服务列表（支持）</li>
<li>查询系统开关（支持）</li>
<li>修改系统开关（支持）</li>
<li>查看系统当前数据指标（支持）</li>
<li>查看当前集群Server列表（支持）</li>
<li>查看当前集群leader（将废弃）</li>
<li>更新实例的健康状态（支持）</li>
<li>批量更新实例元数据(Beta，不支持)</li>
<li>批量删除实例元数据(Beta，不支持)</li>
</ul>
<h3>控制台</h3>
<ul>
<li>完全兼容配置中心相关页面及功能</li>
<li>完全兼容权限控制相关页面及功能</li>
<li>完全兼容命名空间相关页面及功能</li>
<li>完全兼容集群管理相关页面及功能</li>
<li>完全兼容服务发现相关页面及功能</li>
</ul>
<h2>生态兼容情况</h2>
<h3>Spring Cloud Alibaba</h3>
<p>可通过指定nacos-client方式，提前使用Nacos2.0长连接功能</p>
<pre><code>    &lt;dependency&gt;
        &lt;groupId&gt;com.alibaba.cloud&lt;/groupId&gt;
        &lt;artifactId&gt;spring-cloud-starter-alibaba-nacos-discovery&lt;/artifactId&gt;
        &lt;version&gt;2.1.5.RELEASE&lt;/version&gt;
        &lt;exclusions&gt;
            &lt;exclusion&gt;
                &lt;groupId&gt;com.alibaba.nacos&lt;/groupId&gt;
                &lt;artifactId&gt;nacos-client&lt;/artifactId&gt;
            &lt;/exclusion&gt;
        &lt;/exclusions&gt;
    &lt;/dependency&gt;
    &lt;dependency&gt;
        &lt;groupId&gt;com.alibaba.cloud&lt;/groupId&gt;
        &lt;artifactId&gt;spring-cloud-starter-alibaba-nacos-config&lt;/artifactId&gt;
        &lt;version&gt;2.1.5.RELEASE&lt;/version&gt;
        &lt;exclusions&gt;
            &lt;exclusion&gt;
                &lt;groupId&gt;com.alibaba.nacos&lt;/groupId&gt;
                &lt;artifactId&gt;nacos-client&lt;/artifactId&gt;
            &lt;/exclusion&gt;
        &lt;/exclusions&gt;
    &lt;/dependency&gt;
    &lt;dependency&gt;
        &lt;groupId&gt;com.alibaba.nacos&lt;/groupId&gt;
        &lt;artifactId&gt;nacos-client&lt;/artifactId&gt;
        &lt;version&gt;2.0.0-BETA&lt;/version&gt;
    &lt;/dependency&gt;
</code></pre>
<h3>Dubbo</h3>
<p>由于Dubbo在配置中心（元数据中心）通过反射获取Nacos客户端的部分内容，因此在对于2.0.0版本客户端暂时无法兼容。
目前已与dubbo社区进行沟通，尽快解决适配问题。</p>
<h3>Nacos Spring Boot</h3>
<p>Nacos spring boot 将会配合新版本Nacos客户端发布一个ALPHA版本。</p>
<h2>使用方式</h2>
<h3>SDK客户端、控制台</h3>
<p>Nacos 2.0.0-BETA版本使用方式和Nacos1.X版本使用完全一致。客户端接口请参考Nacos1.X的<a href="https://nacos.io/zh-cn/docs/sdk.html">SDK文档</a>。</p>
<h3>服务端</h3>
<p>Nacos 2.0.0-BETA服务端的部署和使用也和旧版本没有太大区别，这里对新版本中新增的数个配置参数进行说明</p>
<table>
<thead>
<tr>
<th>参数</th>
<th>默认值</th>
<th>描述</th>
</tr>
</thead>
<tbody>
<tr>
<td>nacos.naming.clean.empty-service.interval</td>
<td>60000(单位毫秒)</td>
<td>Nacos自动清理空服务的工作间隔，将替代旧版本中的<code>nacos.naming.empty-service.clean.period-time-ms</code>参数</td>
</tr>
<tr>
<td>nacos.naming.clean.empty-service.expired-time</td>
<td>60000(单位毫秒)</td>
<td>Nacos判断可清理的空服务的过期时间，当服务没有发布的实例，且超过该过期时间未发生更新后，将被判定为过期空服务而移除</td>
</tr>
<tr>
<td>nacos.naming.clean.expired-metadata.interval</td>
<td>5000(单位毫秒)</td>
<td>Nacos自动清理过期元数据的工作间隔</td>
</tr>
<tr>
<td>nacos.naming.clean.expired-metadata.expired-time</td>
<td>60000(单位毫秒)</td>
<td>Nacos自动清理过期服务的过期时间，当服务或实例本身被移除超过该设定时间后，元数据信息将会被移除</td>
</tr>
</tbody>
</table>
<h2>FAQ</h2>
<h3>为什么暂不支持平滑升级，之后能支持吗？</h3>
<p>由于Nacos服务发现模块的服务模型和数据模型都经过重新设计，因此数据结构等发生了比较大的变化，所以暂时不支持平滑升级。
在2.0.0正式版本发布的时候，会支持部分1.X版本到该版本的平滑升级，具体信息在正式发布时会更新升级相关的文档。</p>
<h3>能否支持Nacos旧版本客户端？</h3>
<p>配置中心兼容支持Nacos1.0起的所有版本客户端，服务发现兼容Nacos1.2起所有版本客户端。
因此建议使用Nacos1.2.0之后版本客户端。
但nacos1.X的客户端不具有长连接能力，因此仍然建议使用Nacos2.0.0客户端。</p>
<h3>启动后，调用openAPI 报错 code:503,msg:server is DOWN now, please try again later!</h3>
<p>Nacos在1.4版本后使用Jraft替换了自研的Raft实现，Jraft的选主比原先自研的Raft更加严格，会记录之前启动时的ip或host。因此重启时如果ip变动了，有可能造成选主失败，从而导致nacos无法正确提供服务。
解决方式为删除nacos目录下的data，再启动。</p>
<p>或者使用<code>-Dnacos.server.ip=${domain}</code>,然后将nacos/conf的cluster.conf配置domain列表，避免重启时ip变动导致的raft选主问题。</p>
<h3>找不到符号<code>com.alibaba.nacos.consistency.entity</code></h3>
<p>这个包目录是由<code>protobuf</code>在编译时自动生成，您可以通过<code>mvn compile</code>来自动生成他们。如果您使用的是IDEA，也可以使用IDEA的protobuf插件。</p>
<h3>待补充...</h3>
</div></div></section><footer class="footer-container"><div class="footer-body"><img src="/img/nacos_gray.png"/><div class="cols-container"><div class="col col-12"><h3>愿景</h3><p>Nacos 通过提供简单易用的动态服务发现、服务配置、服务共享与管理等服务基础设施，帮助用户在云原生时代，在私有云、混合云或者公有云等所有云环境中，更好的构建、交付、管理自己的微服务平台，更快的复用和组合业务服务，更快的交付商业创新的价值，从而为用户赢得市场。</p></div><div class="col col-6"><dl><dt>文档</dt><dd><a href="/zh-cn/docs/what-is-nacos.html" target="_self">概览</a></dd><dd><a href="/zh-cn/docs/quick-start.html" target="_self">快速开始</a></dd><dd><a href="/zh-cn/docs/contributing.html" target="_self">开发者指南</a></dd></dl></div><div class="col col-6"><dl><dt>资源</dt><dd><a href="/zh-cn/community/index.html" target="_self">社区</a></dd><dd><a href="https://cn.aliyun.com/product/aliware/mse?spm=nacos-website.topbar.0.0.0" target="_self">云服务 MSE</a></dd><dd><a href="https://www.aliyun.com/product/edas?source_type=nacos_pc_20181219" target="_self">云服务 EDAS</a></dd><dd><a href="https://www.aliyun.com/product/ahas?source_type=nacos_pc_20190225" target="_self">云服务 AHAS</a></dd></dl></div></div><div class="copyright"><span>@ 2018 The Nacos Authors | An Alibaba Middleware (Aliware) Project</span></div></div></footer></div></div>
	<script src="https://f.alicdn.com/react/15.4.1/react-with-addons.min.js"></script>
	<script src="https://f.alicdn.com/react/15.4.1/react-dom.min.js"></script>
	<script>
		window.rootPath = '';
  </script>
	<script src="/build/documentation.js"></script>
</body>
</html>